home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir39 / 4derr210.zip / ON!ERROR.DOC < prev   
Text File  |  1994-09-22  |  7KB  |  135 lines
  1.  
  2.                              ON!ERROR.BTM
  3.                              Version 2.10
  4.                             Sept. 22, 1994
  5.                                 ******
  6.  
  7.  
  8.      This archive contains On!Error, a BTM script file I wrote to 
  9. provide an extended command line error handling function in version 
  10. 5.0, or later of 4DOS, JP Software's command processor replacement for 
  11. DOS. The idea for this was sparked by an article in the March - April 
  12. 1994 issue (No. 66) of the 'The Computer Journal' by Jay Sage. I wish 
  13. to thank him for this idea, and all the other great ideas he has given 
  14. me over the years. Thanks, Jay!
  15.  
  16.      To use this BTM script file, the user should first use the 4Dos 
  17. MEMORY command, to check to see if there is at least 128 bytes free in 
  18. the environment. If there is not, the user should examine the two 
  19. directives shown below in their current 4DOS.INI configuration file.
  20.  
  21.      ;* Define the global environment space for the system.
  22.      Environment = 512
  23.      ;* Define the additional space for the secondary processor.
  24.      EnvFree = 128
  25.  
  26.      Please be aware, that the two values shown here, are the normal 
  27. 4Dos default values, and on most systems this should be adequate. 
  28. However, if you do need to increase the amount of space in the 4Dos 
  29. environment, you should change the 'Environment' directive by an 
  30. amount equal to the difference of 128 less the free space in your 
  31. present environment. For example, if after using the MEMORY command, 
  32. you discover there is only 80 bytes free, you should then increase 
  33. your 'Environment' value by at least 48 bytes (128 - 80 = 48) so a 
  34. setting of 560, or higher would be fine.
  35.  
  36.      Next the user must move the ON!ERROR.BTM file in this archive to 
  37. the place on their hard drive where their 4Dos script files are 
  38. stored. Then the user simply add the following alias to his, or her, 
  39. 4Dos alias command file:
  40.  
  41.      :* Unknown Command Alias to invoke Error Handler BTM file.
  42.      :* (Used when command processor can't resolve command line!)
  43.      Unknown_Cmd=call c:\4dos\on!error
  44.  
  45.      Of course, the above drive - path reference should be adjusted as 
  46. needed to wherever the user's batch, and 4Dos BTM files are normal 
  47. stored on their hard drive, or ram disk. Also, you *MUST* use a call 
  48. statement to invoke this BTM script file so the error handler script 
  49. can properly service other batch and BTM files.
  50.  
  51.       Once installed, this BTM script file will trap ALL command 
  52. lines, that the 4DOS command processor can't resolve, by using the new 
  53. unknown command feature in version 5.0, or later, of 4DOS. After 
  54. indicating that a command error has occurred, the offending command 
  55. line will be presented to the user for possible editing before 
  56. proceeding with the execution of it again by pressing Return (Enter). 
  57. The user may also choose to delete the line by pressing the Escape 
  58. key, and then Return (Enter) to cancel the command line.
  59.  
  60.      Should the user wish to abort all further processing by this BTM 
  61. script file, then pressing a 'Ctrl-C', or a 'Ctrl-Break', will abort 
  62. the script, and immediately return the user to the command line prompt, 
  63. or to the calling program.
  64.  
  65.  
  66.                                 *****
  67.  
  68.      NOTE: While the On!Error.Btm script file will work right out of 
  69. the box, since it only uses normal 4DOS commands, the script code does 
  70. provide for an enhancement.
  71.  
  72.      X.COM, by Keith Ledbetter, is a freeware program that provides a 
  73. means of saving disk space by grouping seldom used external DOS 
  74. commands, batch files, and other programs, into a PKZIP type archive. 
  75. X.COM then allows execution of the programs stored in this command 
  76. archive, by invoking PKUNZIP to extract them, run them, and then 
  77. delete them from the disk. When combined with the capabilities of 
  78. 4DOS, this whole process can be easily automated, and made transparent 
  79. to the user working at the command line. I use this on my own system, 
  80. and have gained back considerable hard disk storage space by placing 
  81. seldom used DOS commands, like BACKUP, FDISK, RESTORE, etc., along 
  82. with software configuration tools, and other seldom used programs in 
  83. the commands archive. If you are interested in using X.COM, then you 
  84. can find it in the X_31.ZIP file found on the BBS where you obtained 
  85. this archive.
  86.  
  87.      If you do decide to try out the X.COM program, first install it 
  88. per the X.COM documentation, then place the X.COM program somewhere 
  89. along your normal system's command search path. Version 2.00 of the 
  90. ON!ERROR.BTM script file contains code to detect the presence of the 
  91. X.COM program file, and automatically invoke it as an extended command 
  92. processor. NO editing changes are needed to the BTM script file, since 
  93. the script file already contains all the code needed to make use of 
  94. the X.COM program.
  95.  
  96.  
  97.                                                  Samuel Vincent
  98.                                                  P.O. Box 82
  99.                                                  Hyde Park, PA
  100.                                                  April 24, 1994
  101.  
  102.  
  103. ---------------------------------------------------------------------
  104. Apr. 24, 1994                                         STV
  105.      Version 1.40 was the initial release of this script file.
  106.  
  107. May 15, 1994                                          STV
  108.      Version 1.50 corrects some problems that I found in my day to
  109.      day use of this script file. I've had to add a trap to deal
  110.      with 'iff...then...else(iff)...endiff' type aliases that are
  111.      aborted prematurely. I also now trap any command verbs that
  112.      contain a wild card (*,?) character. Finally, I redesigned the
  113.      output to present a somewhat more informative display.
  114.  
  115. Sept. 1, 1994                                          STV
  116.      Version 2.00 added code to make automatic use of the X.COM
  117.      program, if it detects it in the system. Also the script file
  118.      corrects the problem of exiting when a Ctrl-C, or Ctrl-Break,
  119.      occurs, while the BTM file is executing. The script will now
  120.      provide for a graceful exit, should the user press Ctrl-C, or
  121.      Ctrl-Break.
  122.  
  123. Sept. 22, 1994                                         STV
  124.      Version 2.10 now saves the corrected command line to the 4Dos 
  125.      history buffer. The script file now uses the current setting of 
  126.      the display's background color, rather than using an absolute 
  127.      color setting. A new exception trap was added to deal with any 
  128.      errors generated from trying to 'quit' or 'cancel' prematurely 
  129.      from inside an alias. Also two other traps were added. The first 
  130.      for when the user tries to use On!Error on a version of 4Dos 
  131.      prior to the 5.0 release. The second to make sure there is enough 
  132.      space free in the environment to run. Finally, all 4Dos commands 
  133.      used in the BTM script were changed so alias expansion would 
  134.      *NOT* occur to help ensure compatibility on any 4Dos system.
  135.